home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / compuserve-file-archive / 16 Vendor Support / FILCON.DOC < prev    next >
Text File  |  2019-04-13  |  6KB  |  234 lines
  1.  
  2. ***************************************
  3. *
  4. * FILCON.BAS instructions.  V1.1
  5. *
  6. * File Conversion program for use with
  7. *       CBterm/C64  (c) 1985 Chrisdos
  8. *
  9. ***************************************
  10.  
  11. IMPORTANT ! For converted file to
  12. correctly load into CBterm/C64, you
  13. must make the following small patch
  14. to CBterm/C64 V2.0
  15. 1) Load CBterm/C64 (do not run it)
  16. 2) type in: POKE 7150,0
  17. 3) SAVE CBterm/C64 back to disk.
  18. (scratch the old version)
  19.  (Ok, so I had a 1 where I should have
  20.   had a 0. No one is perfict.)
  21. This patch tells CBterm/C64 to load
  22. files made by FILCON to the correct
  23. locations in memory.
  24. ---------------------------------------
  25.  
  26. Filcon has 3 main functions.
  27.         1) Converting of file types.
  28.                 (PRG/SEQ)
  29.  
  30.         2) Converting ASCII/PETSCII
  31.  
  32.         3) Printing or displaying.
  33.  
  34. Operation: Filcon.bas is a basic
  35. program with a M/L routine in data
  36. statements. Load and run Filcon and
  37. it will poke the M/L part into memory.
  38. The screen will clear and you will
  39. be presented with the menu.
  40.  
  41.  
  42.  
  43. 1) File Type Conversion.
  44.         The first 4 menu selections
  45. allow you to load or save either
  46. a PRG type text file, (like ones
  47. created by CBterm/C64) or SEQ files
  48. (like those from text editors or
  49. what ever). 
  50. Filcon is a GENERAL file converion
  51. program and may work with other
  52. program's text files also, not only
  53. CBterm/C64's.
  54.         Options 1 and 2 load and save
  55. PRG type text files. 3 and 4 do the
  56. same for SEQ type text files.
  57.  
  58.         Simply select the option you
  59. need to load or save the text file
  60. you are working on, you will be
  61. prompted for the file name.
  62. If you hit one of these options by
  63. mistake, just hit <RETURN> for the
  64. file name and you will abort the 
  65. operation.
  66.  
  67.  
  68. 2) Case conversion.
  69.         Once you have loaded the
  70. file into memory, you can convert
  71. the characters as needed to conform
  72. to your application.
  73. That is, you may convert the file in
  74. any of the following ways:
  75.         ASCII to PETSET2
  76.         PETSET2 to ASCII
  77.         PETSET2 to PETSET1
  78.         ASCII to PETSET1
  79.         ALL to Upper Case ASCII
  80.         ALL to Lower Case ASCII
  81.  
  82. Of the 6 options, the first 2 are the
  83. most usefull as these are the ones
  84. are convert ASCII to U/L case PETSCII
  85. and back again.
  86. The others are included for those
  87. special times when nothing else will
  88. do.
  89. This is a list of what each conversion
  90. does:
  91. (65-90 to 193-218 means that characters
  92. 65 thru 90 are mapped to characters
  93. 193-218. These are ASCII Cap. A-Z to
  94. PETSCII Set 2 Cap. A-Z. 
  95. IE. 128 is added to the code.)
  96.  
  97.         5 ASCII to PETSET2
  98.           65-90 to 193-218
  99.           97-122 to 65-90
  100.  
  101.         6 PETSET2 to ASCII
  102.           65-90 to 97-122
  103.           193-218 to 65-90
  104.  
  105.         7 PETSET2 to PETSET1
  106.           193-218 to 65-90
  107.  
  108.         8 ASCII to PETSET1
  109.           97-122 to 65-90
  110.  
  111.         9 ALL to UPPER Case ASCII
  112.           193-218 to 65-90
  113.           97-122 to 65-90
  114.  
  115.        10 ALL to LOWER Case ASCII
  116.           193-218 to 65-90
  117.           65-90 to 97-122
  118.  
  119. (65-90 are ASCII and PETSET1 CAP. A-Z
  120.  and also PETSET2 LOWER a-z.
  121.  97-122 are ASCII LOWER a-z.
  122.  193-218 are PETSET2 CAP. A-Z.
  123.  Of course some codes display as
  124.  graphics in PETSET1.)
  125.  
  126. Remember: FILCON and be used on just
  127. about any TEXT file you can load in to
  128. it. So it could be used to convert
  129. files from other programs.
  130.  
  131. The conversion process is all M/L so
  132. it is FAST. Once the file has been
  133. converted you should SAVE it back
  134. to disk in what ever format (PRG or SEQ)
  135. that you require.
  136.  
  137. 3) The P option on the menu allows
  138. you to Display or Print the file.
  139. After hitting P you will be asked
  140. for Screen or Printer. (If you just
  141. press <RETURN> output will be to the
  142. screen.)
  143. If output is to the printer, you are
  144. asked for a secondary address. This
  145. is needed for some printer interfaces.
  146. If you do not need a secondary address
  147. just hit <RETURN>.
  148. You are then asked if you wish to
  149. Print or Display in FAST mode.
  150. If you enter "Y" then FILCON will
  151. dump to the Printer or Screen via
  152. a M/L routine. There is no way to
  153. halt the Display untill the end
  154. of the file is reached. If output
  155. is to the printer, you may abort the
  156. printing by taking the printer fully
  157. off line. There are no Line Feed
  158. controls in FAST mode, it is a 
  159. fast dump of RAM to the device.
  160. At the end, you are returned to
  161. the menu.
  162. If you do not select FAST mode
  163. you continue the these next
  164. questions and the outputing
  165. is done by a basic loop.
  166. In normal mode, you are given the option
  167. of including a LINE FEED after a
  168. <RETURN> code or stripping the LINE
  169. FEEDS.
  170. If the file you are working on does
  171. not have LINE FEEDS included and
  172. your printer needs them, then hit "Y"
  173. to the Add LINE FEEDS question. If
  174. your file has LINE FEEDS and your 
  175. printer does not need them, hit "Y"
  176. to the Strip LINE FEEDS question.
  177.  
  178.         The file located in memory
  179. will then print or display as required.
  180. Pressing any key during a normal print or
  181. display will abort the routine.
  182.  
  183. ---------------------------------------
  184. The program FILCON.BAS (c) 1985 by
  185. Chrisdos. All rights reserved.
  186.  
  187.  
  188.  
  189.  
  190. Usage notes:
  191.         To convert a file created with
  192. CBterm/C64 to a standard SEQ file,
  193. load the CBterm/C64 file with option
  194. 1 then save it with option 4.
  195.         To convert a SEQ file to
  196. CBterm/C64 format, load with 3 and
  197. save with 2.
  198.         You may also have to use
  199. one of the Case Convert options
  200. depending on the kind of characters in
  201. your files.
  202. CBterm/C64 PRG files are TRUE ASCII.
  203. Please also not that the largest file
  204. FILCON.BAS can handle is 21,502
  205. characters long. (Same length as
  206. CBterm/C64)
  207.  
  208.  
  209. One other IMPORTANT note on CBterm/c64 V2.0
  210. At any time when you LOAD a file into CBterm/C64
  211. it shold not exceed 21502 characters in lenght.
  212. A file 21502 long will just fill the alloted
  213. buffer in CBterm/C64 and cause the RAM messages
  214. to show $0000 room left in memory, this is normal.
  215. HOWEVER, DO NOT OPEN (C= O) the RAM buffer if the
  216. file you loaded compleatly fills the buffer. A
  217. minor bug in V2.0 fails to tell the program
  218. that the buffer has been fully loaded. This
  219. ONLY occures on a load from DISK and the
  220. buffer is compleatly filled. Everything is
  221. fine in the operation of recived modem data
  222. and the buffer closes automaticly when the limit
  223. is reached. It is also ok to open the buffer
  224. to append data after a disk load if the
  225. disk load did not compleatly fill the buffer.
  226. Of cousre, you may reset the buffer at anytime
  227. with the (C= Z) zero fnction. This bug will
  228. be corrected in later versions of CBterm/C64
  229. Thnak you !
  230. -Chrisdos
  231.  
  232.  
  233.  
  234.